home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / rlog.man < prev    next >
Encoding:
Text File  |  1989-01-06  |  6.3 KB  |  199 lines
  1.  
  2.  
  3.  
  4. RLOG                      User Commands                      RLOG
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      rlog - print log messages and other information about RCS
  10.      files
  11.  
  12. SSYYNNOOPPSSIISS
  13.      rrlloogg [ options ] file ...
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.      _R_l_o_g prints information about RCS files.  Files ending in
  17.      `,v' are RCS files, all others are working files. If a work-
  18.      ing file is given, _r_l_o_g tries to find the corresponding RCS
  19.      file first in directory ./RCS and then in the current direc-
  20.      tory, as explained in _c_o(1L).
  21.  
  22.      _R_l_o_g prints the following information for each RCS file: RCS
  23.      file name, working file name, head (i.e., the number of the
  24.      latest revision on the trunk), default branch, access list,
  25.      locks, symbolic names, suffix, total number of revisions,
  26.      number of revisions selected for printing, and descriptive
  27.      text. This is followed by entries for the selected revisions
  28.      in reverse chronological order for each branch. For each
  29.      revision, _r_l_o_g prints revision number, author, date/time,
  30.      state, number of lines added/deleted (with respect to the
  31.      previous revision), locker of the revision (if any), and log
  32.      message.  Without options, _r_l_o_g prints complete information.
  33.      The options below restrict this output.
  34.  
  35.      --LL        ignores RCS files that have no locks set; con-
  36.                venient in combination with --RR, --hh, or --ll.
  37.  
  38.      --RR        only prints the name of the RCS file; convenient
  39.                for translating a working file name into an RCS
  40.                file name.
  41.  
  42.      --hh        prints only RCS file name, working file name,
  43.                head, default branch, access list, locks, symbolic
  44.                names, and suffix.
  45.  
  46.      --tt        prints the same as --hh, plus the descriptive text.
  47.  
  48.      --bb        prints information about the revisions on the
  49.                default branch (normally the highest branch on the
  50.                trunk).
  51.  
  52.      --dd_d_a_t_e_s   prints information about revisions with a checkin
  53.                date/time in the ranges given by the semicolon-
  54.                separated list of _d_a_t_e_s.  A range of the form
  55.                _d_1<_d_2 or _d_2>_d_1 selects the revisions that were
  56.                deposited between _d_1 and _d_2, (inclusive).  A range
  57.                of the form <_d or _d> selects all revisions dated _d
  58.                or earlier.  A range of the form _d< or >_d selects
  59.                all revisions dated _d or later.  A range of the
  60.  
  61.  
  62.  
  63. Purdue University                                               1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RLOG                      User Commands                      RLOG
  71.  
  72.  
  73.  
  74.                form _d selects the single, latest revision dated _d
  75.                or earlier.  The date/time strings _d, _d_1, and _d_2
  76.                are in the free format explained in _c_o(1L).  Quot-
  77.                ing is normally necessary, especially for < and >.
  78.                Note that the separator is a semicolon.
  79.  
  80.      --ll[_l_o_c_k_e_r_s]
  81.                prints information about locked revisions.  If the
  82.                comma-separated list _l_o_c_k_e_r_s of login names is
  83.                given, only the revisions locked by the given
  84.                login names are printed.  If the list is omitted,
  85.                all locked revisions are printed.
  86.  
  87.      --rr_r_e_v_i_s_i_o_n_s
  88.                prints information about revisions given in the
  89.                comma-separated list _r_e_v_i_s_i_o_n_s of revisions and
  90.                ranges. A range _r_e_v_1-_r_e_v_2 means revisions _r_e_v_1 to
  91.                _r_e_v_2 on the same branch, -_r_e_v means revisions from
  92.                the beginning of the branch up to and including
  93.                _r_e_v, and _r_e_v- means revisions starting with _r_e_v to
  94.                the end of the branch containing _r_e_v. An argument
  95.                that is a branch means all revisions on that
  96.                branch. A range of branches means all revisions on
  97.                the branches in that range.
  98.  
  99.      --ss_s_t_a_t_e_s  prints information about revisions whose state
  100.                attributes match one of the states given in the
  101.                comma-separated list _s_t_a_t_e_s.
  102.  
  103.      --ww[_l_o_g_i_n_s]
  104.                prints information about revisions checked in by
  105.                users with login names appearing in the comma-
  106.                separated list _l_o_g_i_n_s.  If _l_o_g_i_n_s is omitted, the
  107.                user's login is assumed.
  108.  
  109.      _R_l_o_g prints the intersection of the revisions selected with
  110.      the options --dd, --ll, --ss, --ww, intersected with the union of
  111.      the revisions selected by --bb and --rr.
  112.  
  113. EEXXAAMMPPLLEESS
  114.              rlog  -L  -R  RCS/*,v
  115.              rlog  -L  -h  RCS/*,v
  116.              rlog  -L  -l  RCS/*,v
  117.              rlog  RCS/*,v
  118.  
  119.      The first command prints the names of all RCS files in the
  120.      subdirectory `RCS' which have locks. The second command
  121.      prints the headers of those files, and the third prints the
  122.      headers plus the log messages of the locked revisions.  The
  123.      last command prints complete information.
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Purdue University                                               2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RLOG                      User Commands                      RLOG
  137.  
  138.  
  139.  
  140. DDIIAAGGNNOOSSTTIICCSS
  141.      The exit status always refers to the last RCS file operated
  142.      upon, and is 0 if the operation was successful, 1 otherwise.
  143.  
  144. IIDDEENNTTIIFFIICCAATTIIOONN
  145.      Author: Walter F. Tichy, Purdue University, West Lafayette,
  146.      IN, 47907.
  147.      Revision Number: 1.2 ; Release Date: 87/03/17 .
  148.      Copyright (C) 1982 by Walter F. Tichy.
  149.  
  150. SSEEEE AALLSSOO
  151.      ci(1L), co(1L), ident(1L), rcs(1L), rcsdiff(1L),
  152.      rcsintro(1L), rcsmerge(1L), rcsfile(5L)
  153.      Walter F. Tichy, "Design, Implementation, and Evaluation of
  154.      a Revision Control System," in _P_r_o_c_e_e_d_i_n_g_s _o_f _t_h_e _6_t_h _I_n_t_e_r_-
  155.      _n_a_t_i_o_n_a_l _C_o_n_f_e_r_e_n_c_e _o_n _S_o_f_t_w_a_r_e _E_n_g_i_n_e_e_r_i_n_g, IEEE, Tokyo,
  156.      Sept. 1982.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Purdue University                                               3
  196.  
  197.  
  198.  
  199.